Operator MediumRgbCamera

Operator Library: Hardware Platform

このオペレーターは、Camera Link MEDIUM RGB構成のカメラからVisualAppletsに画像データを転送します。 Camera Link規格の3つのMEDIUM RGB構成がサポートされています。

[重要] 「タップ」の定義

本書で使用されるワンタップとは、任意のBit Widthを持つ、デコードされた1つのカラーコンポーネントを意味します。

CameraLink Specification Version 2.1では、ワンタップはすべてのカラーコンポーネントを含む1つのカラーピクセルとして定義されていることに注意してください。

次の表は、VisualAppletsの表記法とCamera Link仕様書バージョン2.1の間のマッピングを示しています:

VA表記 CameraLink表記
Tap3x10 ................ 10-Bit RGB Medium 1 tap
Tap3x12 ................ 12-Bit RGB Medium 1 tap
Tap6x8 .................. 8-Bit RGB Medium 2 taps

表 63. VAの表記法とCamera Link仕様書バージョン2.1のマッピング


次の図は、これらのモードにおけるピクセルマッピングを示しています。

Tap3x10bitおよびTap3x12bit:

Tap6x8bit:

このオペレーターは、CameraPortタイプの2つのリソースを排他的に使用します。 したがって、フレームグラバーのポートA(0)とポートB(1)の両方のポートが占有され、他のオペレーターで使用することはできません。 同じリソースインデックスは、アプレットごとに1回のみ使用できます。

ハードウェアプラットフォームで使用可能
mE5 marathon VCLx
mE5 marathon VCL
LightBridge VCL
mE5 VD8-PoCL (ironman)

I/O Property

Property 値
オペレータータイプ M
Output Link O、画像データ出力

サポートされているリンクフォーマット

Link Parameter Output Link O
Bit Width [3,63]1
Arithmetic unsigned
Parallelism 任意、パラメータの説明を参照
Kernel Columns 1
Kernel Rows 1
Img Protocol {VALT_IMAGE2D,VALT_LINE1D}
Color Format VAF_COLOR
Color Flavor FL_RGB
Max. Img Width 任意
Max. Img Height 任意

1

RGBタプルのため、Bit Widthは3の倍数である必要があります。

パラメータBitWidthには、カメラから実際に送信されるBit Widthよりも大きい値または小さい値を設定できます。

カメラから実際に送信されるBit Widthよりも小さい値がパラメータに設定されている場合、 ピクセルコンポーネントの最下位ビット(LSB)が切り捨てられます。 ピクセルコンポーネントごとの最上位ビット(MSB)のみがVisualAppletsに転送されます。

パラメータにカメラから送信される実際のBit Widthよりも大きい値を設定した場合、元のピクセルコンポーネントは出力されるピクセルコンポーネントのMSB位置に配置されます。LSBはゼロでFillされます。

どちらの場合も、相対的な明るさは変わりません。つまり、白いピクセルは白のままで、暗いピクセルは暗いままになります。

パラメーター

DvalMode
タイプ 動的書き込みパラメータ
Default DVAL_Enabled
範囲 {DVAL_Enabled, DVAL_Disabled}

DVALを使用して有効なピクセルをマスクするか、それとも無視するかを指定します。 DVALが無視される場合、有効なピクセルはLVALおよびFVALのステータスに従って選択されます。

FvalMode
タイプ dynamic/static write parameter
Default CameraLinkStandard
範囲 {CameraLinkStandard, IgnoreFval}
  • CameraLinkStandard

    オペレーターはカメラからのフレーム有効(FVAL)信号を待機します。 この場合、オペレーターはFVALサイズに従ってフレームを出力します。

  • IgnoreFval

    この設定を使用すると、オペレーターはカメラからのFVAL信号をすべて無視します。 すべての入力ラインが使用され、無限の高さを持つ単一の画像にマージされます。

    [注] Output Image Protocol VALT_IMAGE2Dでのみ利用可能です

    このパラメータは、出力が画像プロトコルVALT_IMAGE2Dに設定されている場合にのみ利用可能です。 VALT_LINE1Dが選択されている場合、パラメータは無効になり、FVALはどちらにしても無視されます。

    [Warning] VisualApplets Link Rules Violation

    カメラオペレーターが無限の高さのフレームを出力する場合、link propertiesで定義されたMax. Img Heightを超える可能性があります。 これにより、VisualAppletsのリンク規則違反が発生します。 有効な高さを必ず使用してください。 SplitImageオペレーターを使用して画像の高さを制限し、無限の画像を複数のチャンクに分割してください。

このパラメータの目的は、エリアスキャンカメラとラインスキャンカメラを同じアプレット内で動的に使用できるようにすることです。

MediumMode
タイプ 動的書き込みパラメータ
Default Tap3x10bit
範囲 {Tap3x10bit, Tap3x12bit, Tap6x8bit}

このパラメータは、MEDIUM構成モードを指定します。

CameraStatus
タイプ 動的リードパラメータ
Default
範囲

LightBridge/marathon: [0;2^24-1]

mE5 VD8 ironman: [0;2^8-1]

Parameter CameraStatus は、プログラミング対象のフレームグラバーのハードウェアによって異なります。 以下に、まず marathon および LightBridge の説明を記載し、その次に mE5 VD8-PoCL (ironman) の説明を記載します。

marathon および LightBridge:

bit[0]: PCLK [0] 利用可能

bit[1]: FVAL [0] 現在値

bit[2]: LVAL [0] 現在値

bit[3]: DVAL [0] 現在値

bit[4-11]: 予約済み

bit[12]: PCLK [1] 利用可能

bit[13]: FVAL [1] 現在値

bit[14]: LVAL [1] 現在値

bit[15]: DVAL [1] 現在値

bit[16-23]: 予約済み

mE5 VD8-PoCL (ironman):

bit[0]: PCLK [0] 利用可能

bit[1]: FVAL [0] 現在値

bit[2]: LVAL [0] 現在値

bit[3]: DVAL [0] 現在値

bit[4]: PCLK [1] 利用可能

bit[5]: FVAL [1] 現在値

bit[6]: LVAL [1] 現在値

bit[7]: DVAL [1] 現在値

CameraLinkCoreReset
タイプ 動的書き込みパラメータ
Default 0
範囲 [0; 1]

サポートに関する問題用に予約されています。

PixelClockX
タイプ 動的リードパラメータ
Default 0
範囲 [0; 85] MHz

MHz単位のカメラチャンネルXのピクセルクロックレート。

PixelClockY
タイプ 動的リードパラメータ
Default 0
範囲 [0; 85] MHz

MHz単位のカメラチャンネルYのピクセルクロックレート。

MinimalParallelism
タイプ static read parameter
Default 2
範囲 [1; 1024]

出力リンクOがデータの損失なしにカメラの最大帯域幅を転送できるようにするための最小の Parallelism。 この値は、現在選択されているデザインクロック周波数によって異なります。 周波数が高くなるほど、Parallelism の値を小さくすることができます。